0006. 分支重命名

• 1. 📝 概述
• 2. 💻 重命名本地分支
• 3. 💻 重命名远程分支

1. 📝 概述

• 重命名 Git 分支分为两种情况：
  • 重命名本地分支
  • 重命名远程分支
• 提前备份：
  • 在执行这些操作之前，建议先备份你的工作或确保你已经提交了所有重要的更改。
• 事前通知：
  • 如果其他开发人员也在使用同一个远程分支，那么重命名分支可能会对他们造成影响。
  • 在这种情况下，最好提前通知他们。
• --delete
  • 使用 --delete 选项时要特别小心，因为它会永久删除远程分支。
  • 确保你不再需要旧的分支名称后再执行此操作。
• 命名
  • 在输入新分支的时候，不能输入空格等非法字符。

2. 💻 重命名本地分支

# 如果你只是想要重命名本地分支（你当前就在此分支上），可以使用以下命令：
git branch -m 新分支名

# 如果当前不在要重命名的分支上，你需要指定旧分支名：
git branch -m 旧分支名 新分支名

3. 💻 重命名远程分支

当你的分支已经被推送到远程仓库时，重命名过程会稍微复杂一点。你需要执行以下步骤：

1

# 重命名本地分支
# 首先按照上述方法重命名本地分支。
git branch -m 旧分支名 新分支名
# 需要注意分支名不要加上前缀 remotes/xxx/，比如：
# ❌ remotes/origin/old_branch 这么写是不对的
# ✅ old_branch 这么写是对的

2

# 删除旧的远程分支
# 使用 `git push` 命令加上 `--delete` 参数来删除远程仓库上的旧分支。
git push origin --delete 旧分支名

3

# 推送重命名后的本地分支到远程仓库
# 使用 `git push` 命令将本地重命名后的分支推送到远程仓库，并设置跟踪关系。
git push origin 新分支名 --set-upstream